home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 151-175 / scopedisk168 / tinytools / clip / clip.man < prev    next >
Text File  |  1995-03-19  |  2KB  |  51 lines
  1.  
  2. NAME
  3.        Clip - Pipe through clipped lines.
  4.  
  5.  
  6. SYNOPSIS
  7.        Clip <Cnt1> [ID1 [x]"charlist"] <Cnt2> [ID2 [x]"charlist"]
  8.  
  9.  
  10. REQUIREMENTS
  11.        The ARP library
  12.  
  13.  
  14. DESCRIPTION
  15.        Clip is a flexible tool for clipping pieces out of input lines.
  16.        Two clip positions may be specified, and, for every input line,
  17.        the text between the clip positions is written to the standard
  18.        output.
  19.        The first clip position is relative to the leftmost byte for
  20.        positive count values, and relative to the rightmost byte for
  21.        negative ones.  The CNTth byte matching any of the bytes in the
  22.        ID's character list is the clip position.
  23.        If the ID string is headed by an "x", the character at the
  24.        clip position will be excluded from the clip. If no bytes are
  25.        specified in the character list, clip will match any byte. Clip
  26.        will default to this if you omit the ID parameter.
  27.        If a clip position couldn't be matched, no clip will be written.
  28.        If, however, no ID is specified, the clip position will be at the
  29.        last byte matched. For large CNT values this will probably be the
  30.        first or last byte of the input line.
  31.        Empty lines are ignored.
  32.  
  33. EXAMPLES
  34.        Clip <TextFile 0 79
  35.        Type only the first 80 columns of a textfile to the console.
  36.        This prevents line wraps.
  37.  
  38.        Assume input lines with paths+filenames;  Clip -1 ID1 "x:/" +400
  39.        will pass through only the filenames, and Clip -1 ID1 ":/" -400
  40.        will pass through the paths.
  41.  
  42.        Assign | Search STDIN volumename: NONUM | Clip 0 +1 ID2 "x " |
  43.                 PForm "Assign %s:" | Execute
  44.        This line will clear a set of logical device names specific to a
  45.        volume.
  46.  
  47.  
  48. BUGS/LIMITATIONS
  49.        The counts start from 0. This is counter-intuitive. Think of them
  50.        as offsets, the first from the edges, the second from the first.
  51.